home *** CD-ROM | disk | FTP | other *** search
/ Shareware Super Platinum 8 / Shareware Super Platinum 8.iso / mac / MODEMPRO / DEP304.ZIP;1 / DEPARC.EXE / README.EXE (.txt) < prev    next >
Encoding:
David's Readme Compiler Executable  |  1992-10-05  |  128.0 KB  |  1,849 lines
  1. 4YY_^
  2. 2YY_^
  3.  H PT
  4.  nY_^
  5. H9E0}
  6.  ; A B D G H I K M O P Q R S s t u vQ
  7. `Y_^]
  8. YYF;6
  9.  A B D7
  10. <Ar    ,@
  11. _^_^]
  12.  H I K M P Q6*6*V*$*{*
  13.  H I Q
  14. YYF;v
  15. ;Dz~    
  16.  H I K M P Q
  17. DF_^]
  18. YY9|,uK
  19. ;D@ui
  20. ;DDu2
  21. H9D0~
  22. 9D<|    u
  23. 17Y;D2v
  24. H9D0u
  25. YY_^]
  26. YY_^]
  27. p5Y)D:
  28. 1Y;D2wK
  29. `[.97t
  30.  G H I K M O P Q R S s t u w
  31. fJfJfFf
  32. eJfJf
  33. eJfJf=f(f#eYe
  34. u/SQR
  35. ntm9n
  36. pfmlmU
  37. [[XP3
  38. !r.RP
  39. !r$RP
  40. t$Ot!
  41. tx#>>
  42. Borland C++ - Copyright 1991 Borland Intl.
  43. Null pointer assignment
  44. Divide error
  45. Abnormal program termination
  46. Courier
  47. ind text   <F7>
  48. find 
  49. gain  <F8>
  50. rint entry     
  51. ave entry      
  52. dit entry      
  53. LPT1:
  54. LPT2:
  55. LPT3:
  56. Printer port :
  57. PostScript?  :
  58. Press <Space> to change values
  59. %!PS-Adobe-2.0
  60. %%Creator:DRC v2.0
  61. %%EndComments
  62. /leftmargin { 40 } bind def
  63. /bot { 54 } bind def /top { 
  64.  } bind def
  65. /cw { 40 } bind def
  66. /xtab
  67.  {currentpoint exch dup cvi
  68.  leftmargin cvi sub cvi
  69.  cw cvi mod sub
  70.  cw add
  71.  exch moveto
  72.  } bind def
  73. /ptsize { 12 } bind def /lead { 12 } bind def
  74. /F { findfont exch scalefont setfont } bind def
  75. /newline {
  76.  currentpoint exch pop lead sub
  77.  dup bot lt {
  78.   pop showpage restore save
  79.   top
  80.   } if
  81.  leftmargin exch moveto
  82.  } bind def
  83. %%Endprolog
  84. %%BeginSetup
  85. ptsize /| F
  86. leftmargin top moveto
  87. %%EndSetup
  88. Do you want to overwrite
  89. %.20s (Y/N)? 
  90. File exists
  91. %-50.50s
  92. newline
  93. ) show newline
  94. newline
  95. showpage restore
  96.  Print Settings 
  97.  - Printing -
  98.  Save as what file? 
  99. Failed saving to file!
  100.  PgUp/Dn: 
  101. <F10>
  102.  options
  103.  PgUp/Dn
  104.  Line %d of %d 
  105.  Search for 
  106. David's Readme Compiler, (c) 1992, David Harris.
  107. Readme error: no attached data.
  108.  Topics 
  109. MMMODE
  110.  ; < = > ? @ A B C D T U V W X Y Z [ \ ]
  111.  G O w u R S s t
  112. EAEIIOOUUYIOU
  113. (press any key to continue)
  114. Insert paper in printer then press
  115. a key (<ESC> cancels print)
  116.  Printer error 
  117. The printer on LPT%d: is
  118. confused
  119. out of paper
  120. off line
  121. Correct then press a key
  122. or hit <ESC> to cancel print
  123.  Insert Paper 
  124. <ESC>
  125.  key pressed:
  126. Please confirm cancel/quit
  127. Accept this data?  
  128.  Insufficient disk space 
  129. There is not enough space on the target
  130. disk to receive the file(s): please replace
  131. the disk with another formatted disk, then
  132. press any key to retry, or <ESC> to cancel 
  133. 0123456789
  134.          !!!!!                  
  135. @@@@@@@@@@@@@@@
  136. @@@@@@@
  137. @@@@@@
  138. @@@@ 
  139. ),(((((),(((
  140. (null)
  141. print scanf : floating point formats not linked
  142. uData file generated by RCOM.
  143.  Deputy Communications Software - A Brief Guide
  144. About Deputy
  145. Deputy's Features
  146. Changes in Version 3.04
  147. The Shareware Concept
  148. Software Licence
  149. How to Register & Price
  150. Installation
  151. Instructions
  152. Notes for distribution
  153. Special Modem Offers
  154. Services from S/E/G
  155. Getting going
  156. Using Menus
  157. Setting up Deputy
  158. The Main Menu
  159. MNP5 Data Compression
  160. File Transfer
  161. The Text Editor
  162. The Dial Directory
  163. Other Features
  164. Deputy Host Mode
  165. Calling the Deputy Host
  166. The Deputy Script Language (DSL)
  167. Script Auto-Learning
  168. Writing your own scripts
  169. DSL Command List
  170. Example Script
  171. Command Line Arguments
  172. Credits
  173.                                  
  174.                                  
  175.      
  176.      
  177.      Advanced Communications software with MNP5 data compression
  178.   (c) 1992 S/E/G Communications  Email: Segcom@cix.compulink.com.uk
  179.             Written by Anders Heerfordt & Michael Spalter
  180.   Thankyou for obtaining this shareware copy of DEPUTY.  There are
  181.   many communications programs around now, but Deputy presents the
  182.   most advanced and useful facilities in a way  which is simple to
  183.   use for the novice and yet not cumbersome for the expert.
  184.   This Brief Guide should hopefully  give you good idea of what to
  185.   expect from Deputy once you start using it. Do remember that any
  186.   section of this guide can be sent to the printer by pressing F10.
  187.   We are sure that you'll find this guide useful and hope that you
  188.   find Deputy suitable for your purposes and will register soon.
  189.   We often make alterations and improvements to Deputy as a result
  190.   of user feedback; because of this, the manual may not always match
  191.   the software exactly.
  192.   Readme Version 1.4
  193.   This Brief Guide was created using DRC by David Harris; he
  194.   can be reached by Email at david@otago.ac.nz.
  195.   MNP is a registered Tradmark of Microcom Inc.
  196.   Deputy is a registered tradmark of S/E/G Communications
  197.   Netware is a registered trademark of Novell Inc.
  198.  Deputy's Main Features 
  199.  Avaiable in FOUR European Languages (more soon !)
  200.  MNP Levels 2,4 & 5 error correction & data compression
  201.  Powerful script language with 'learn' facility and
  202.     supporting 32 bit integers, string/integer arrays,
  203.     calling of daughter scripts and random access filing.
  204.  VT52/100/200/320, ANSI, Prestel, Minitel & Wyse60 Emulations
  205.  Full mouse support, including script language commands
  206.  Background file transfers - including droping to DOS
  207.  Zmodem, Xmodem, Ymodem, YmodemG, ASCII & Kermit protocols
  208.  Full history logs of all file transfers, with CPS rates
  209.  Built-in context sensitive informative help screens
  210.  Host mode with messaging and file transfer facilities
  211.  User friendly dial directory with history of all calls
  212.  Support for all DTE rates up to 115200 bps & 1200/75 split
  213.  Novell (tm) NACS/NASI Interface with multi-session support
  214.  Easy to learn user interface with 'Hot-Key' commands
  215.  Support for 16550 buffered UARTS & INT14 interfaces
  216.  Pop-up menu windows can be shifted horizontally/vertically
  217.  External protocol support & 43/50 line VGA modes
  218.  Mercury compatibility with id encryption (UK only)
  219.  Changes in Version 3.04 
  220.  Since version 3.00, user feedback has  enabled  us  to  make  various
  221.  changes  to  Deputy to make it even more user friendly.  In addition,
  222.  we have made various performance  enhancements  and  added  some  new
  223.  features.   Notably,  the  user  interface  has now been changed to a
  224.  'pull down' style and you can now use a mouse to control Deputy.  The
  225.  following  list  details  most  of  the  noticable  changes,  in   no
  226.  particular  order. Further details are given at the bottom:
  227.  * All IRQ's from 2-7 are now allowed for custom ports
  228.  * Message to show 'no scripts' added.
  229.  * Script menu is now not limited to 15 script names
  230.  * DSL Commands added:
  231.    NAP, DTR, CTS, RTS, RI, DSR, WrStr, FSeek
  232.    FTell, FRdChar, FWrChar, CloseGrab, TDelay
  233.  * New DSL command: SendChar(ch:CHAR) added to script language.
  234.  * New DSL command: SetRawLog(b:BOOLEAN) added to script language.
  235.  * effect of /r in strings changed to carriage return only
  236.  * Integers are now 32 bits
  237.  * Menuing system redesigned; now uses a 'pull down' system.
  238.  * String Arrays are now fully tested and supported
  239.  * Mouse support added ! Left button brings up menu.
  240.  * Mouse(Boolean) DSL command added - enables the mouse cursor
  241.  * ReadMouse() DSL function returns buttons pressed
  242.  * WhereMouse(X,Y) will return 0-79,0-24 giving mouse position
  243.  * Fsize and Diskspace now return results in bytes not Kb
  244.  * File Menu now shows printer status (on or off)
  245.  * Self-contained manual now has a search option.
  246.  * Mercury dialling tidied up on the screen
  247.  * Zmodem transfers speeded up on 8250 and slow machines.
  248.  * 43/50 line mode routines changed.
  249.  * When trying to load too large a file to editor, it will refuse.
  250.  * Selecting port that doesnt 'exist' will give you warning
  251.  * 16550 FIFO status restored when program exits
  252.  * Some work done to make shelling to DOS safer under DOS5 and later.
  253.  * Kermit changed to make it better cope with parity errors on Kermit7.
  254.  * Kermit7 protocol added to upload menu
  255.  * 'Type' option moved to upload menu
  256.  * Upload directory added to file transfer setup menu
  257.  * The -Z command line option now disables Zmodem streaming
  258.  * Kermit changed so that the AddCR doesn't have an effect.
  259.  * Shareware message is now not flashing and is less frequent.
  260.  * Keyboard is polled less frequently during file downloads.
  261.  * Some changes to the sequence of events at loadtime/exittime
  262.  * Change to learn mode, to do with the effect of ESC.
  263.  * If program runs out of free memory, ESC won't misbehave.
  264.  * Some causes of obscure hangs fixed
  265.  * Various 'little niggles and quirks' changed
  266.  * Array elements can be set by procedures such as read();
  267.  * Compiler won't scroll seeen if there's an error
  268.  * Pressing Ctrl-Space when online now sends a 'null'.
  269.  * The Macros from the setup are now set when the program loads.
  270.  * Macros are reset when carrier drops.
  271.  * The cursor is forced on when the program exits
  272.  * DSL command Pos() now returns -1 if it doesnt find a match.
  273.  * Mouse now also works in Y/N windows. Works as ESC in menus.
  274.  * Changes done done to Minitel in the areas of inverted attribute,
  275.    double hight attribute, accents, and undocumented terminall features.
  276.  * Changes to make cursor come out in proper shape after videomode changes.
  277.  * Install program altered and made friendlier
  278.  * A problem with Wyse semigraphics sometimes not working, fixed.
  279.  Change Details 
  280. 1. The structures of both the dial directory and configuration
  281.    files for Deputy have altered since version 3.00. We apologise
  282.    for any inconvenience this may cause. As such, you will need
  283.    to re-enter all information. Ensure that you note down all
  284.    dial directory details before deleting the old one !
  285. 2. The user interface has been somewhat redesigned since
  286.    version 3.00. A proper pull down system now exists
  287.    with which you can move from menu to menu using the
  288.    left and right arrow keys. When you select any of
  289.    Deputy's top level menus, a bar menu also appears
  290.    at the top of the screen. Pressing the 'Ctrl' key
  291.    with the cursor keys now moves windows around.
  292. 3. You can now use the mouse to move around and select menus.
  293.    From main terminal mode, press the LEFT button to bring up
  294.    the new Deputy bar menu. RIGHT button simulates Escape.
  295. 4. The following DSL commands have been added:
  296.    PROC Nap();              Sends script 'to sleep' until carrier drop
  297.    PROC DTR(BOOLEAN);       Toggles the status of the DTR output
  298.    PROC RTS(BOOLEAN);       Toggles the status of the RTS output
  299.    FUNC CTS() : BOOLEAN;    Returns the status of the CTS input
  300.    FUNC DSR() : BOOLEAN;    Returns the status of the DSR input
  301.    FUNC RI()  : BOOLEAN;    Returns the status of the RI input
  302.    PROC CloseGrab(Handle);  Cancels a previous 'Grab' command
  303.    PROC TDelay(ticks);      Waits the duration (tick = 1/18 second)
  304.    PROC SendChar(char);     Transmits a single character
  305.    PROC SetRawLog(BOOLEAN); Selects log type (Raw or Clean)
  306.    PROC Mouse(BOOLEAN);     Enables/Disables the mouse cursor
  307.    PROC WhereMouse(X,Y);    Returns mouse cursor position
  308.    FUNC ReadMouse();        Returns mouse buttons pressed
  309.    PROC FSeek(Handle,Pos);  Moves file pointer to position 'Pos'
  310.    FUNC FTell(Handle) : INTEGER;  Returns file pointer position
  311.    The syntax of the following command has changed, as shown:
  312.    FUNC FRdChar(Handle) : CHAR;             (see page 17-12.1)
  313.    The following commands now return size in bytes, not Kbytes:
  314.    FSize(Filename);    DiskSpace();         (see page 17-13)
  315.  The Shareware Concept 
  316.    This  software  is  provided on a try-before-you-buy arrangement.
  317.    You may use the software for up to 30 days  without  payment,  to
  318.    determine if it meets your requirements. If, after this time, you
  319.    wish to continue using the software, you are required to register
  320.    it  and make full payment. Payment entitles you to continue using
  321.    the software; in addition you will receive a printed manual and a
  322.    copy of the latest (non-shareware) version of Deputy.
  323.    Also,  once you register Deputy,  you will be entitled to receive
  324.    updates of the software for one year, subject to a small handling
  325.    fee to cover the costs of distribution. You will also be entitled
  326.    to 90 days  unlimited telephone  support from our  London office.
  327.    Technical support is also available on Compuserve,  Cix and other
  328.    commercial online system in the UK and Worldwide.
  329.    You are encouraged to distribute the shareware  version  of  this
  330.    software  amongst friends and collegues and upload it to bulletin
  331.    boards so that others can evaluate it; it must be distributed  in
  332.    its  original  form  and  complete with all associated files.  No
  333.    money may be  charged  for  such  distribution,  other  than  for
  334.    legitimate  copying  or media charges. Deputy may not be supplied
  335.    as part of any other  purchase  without  written  permission.  We
  336.    reserve the right to withdraw or alter this licence at any time.
  337.    The Shareware Concept relies on honesty; many months of hard work
  338.    have gone into creating this software.  Continued development can
  339.    only be possible by support from the users. If you have comments,
  340.    suggestions (or even complaints) about the software please let us
  341.    know about them.
  342.    Remember that this shareware version of  Deputy,  although  fully
  343.    functional,  is only intended to give you a trial-run of Deputy -
  344.    there are some facilities which to take full  advantage  of,  you
  345.    may  need  to refer to the manual which you will receive when you
  346.    register.
  347.  Software Licence 
  348.   This  user  manual  and  the  associated software is protected by
  349.   international copyright law. Unauthorised duplication, other than
  350.   that allowed under the shareware  distibution  concept  described
  351.   herein  is prohibited.  Please read the licence terms shown below
  352.   before using this software. ALL TRADEMARKS ACKNOWLEDGED. 'MNP' is
  353.   a registered trademark of Microcom Corp.  'Hayes'  is  (c)  Hayes
  354.   Inc.    MS-DOS   is   (c)   Microsoft   Corp.   'Deputy'  is  (c)
  355.   S/E/G Communications.
  356.   Deputy  is  NOT  'free'  or  'public  domain'  software.   Deputy
  357.   (comprising  the   software,  utilities, supporting files and all
  358.   documentation) is the copyright property of S/E/G Communications.
  359.   It  may not be duplicated in part or full, except under the terms
  360.   laid out in the shareware agreement shown elsewhere.  Deputy  may
  361.   not be  supplied  with  any  other  paid-for  goods  or  services
  362.   without prior written permission. S/E/G  may at any time withdraw
  363.   the shareware licence. Due to our continuing programme of ongoing
  364.   product development,  we cannot guarantee that these instructions
  365.   will match the software exactly; from time to time,  features are
  366.   added, removed or altered.  It should be remembered that although
  367.   Deputy  provides compatibility with various terminal emulations,
  368.   there are many differences between PC's and dedicated  terminals;
  369.   as such, various compromises have to be made with the emulations.
  370.   The  software  and  documentation  may   not   be   modified   or
  371.   reverse-engineered in any way.  The software is provided "as-is".
  372.   Neither  S/E/G Communications  or  the authors offer any warranty
  373.   that Deputy is suitable for  your  purposes  or  error-free.   No
  374.   responsibility  is  accepted  for any loss arising as a direct or
  375.   indirect result of using the software. This being so, every  care
  376.   has  been  taken  to ensure that the software is free of defects.
  377.   Users are granted a non-exclusive licence to sample the software,
  378.   but ownership of  the  software  and  documentation  remains  the
  379.   property of the copyright owners.  Usage outside the terms of the
  380.   shareware terms stated elsewhere in this document is prohibited.
  381.   IN ADDITION TO THE ABOVE, ALL PARTIES ARE PROTECTED BY ANY
  382.   STATUTORY LAWS IN THEIR COUNTRY, PARTICULARLY THOSE RELATED TO
  383.   COPYRIGHT AND SOFTWARE THEFT. ANY PERSON OR ORGANISATION FOUND
  384.   CONTRAVENING ANY TERMS OF THIS LICENCE ARE LIABLE TO PROSECUTION.
  385.  Deputy Registration Details 
  386.   For your convenience,  print out the following order form;  to do
  387.   so,  ready your printer  and then press 'P'.  The easiest  way to
  388.   register Deputy is with your credit card. You can make your order
  389.   by fax, phone or mail or E-mail. Site licences are available. For
  390.   users in the USA, please see the other section "Foreign Orders".
  391. The current registration price is 
  392. 49 (UK Pounds), until 31/12/92
  393.     Surname ......................... Initials ................
  394.     Company Name (if applicable) ..............................
  395.     Address ...................................................
  396.     ...........................................................
  397.     From where did you obtain Deputy ? ........................
  398.     Please supply ...... copies of Deputy at 
  399. 49 each (UK Pounds)
  400.     Language Required ............ (USER GUIDE IS ONLY IN ENGLISH)
  401.     The standard manual is spiral bound. A deluxe manual with
  402.     larger paper and in a smart ring binder with a slip case is
  403.     also available at an additional 
  404.     Carriage:  
  405. 3 UK    
  406. 5 Europe    
  407. 7 Rest of the world
  408. VAT @ 17.5% must be added to all orders within the UK
  409.     (e.g. One copy of Deputy, for UK delivery is 
  410. 61.10 inc.)
  411.     Total Payable ...............  Disc Size: 3.5 / 5.25 / 360K
  412.     Payment by: Money order / Visa / Mastercard / Cheque
  413.     Card Number ............................... Expires .......
  414.     Cardholder Name/Address ...................................
  415.     ...........................................................
  416.     An invoice will  be  provided. Send or Fax completed form to:
  417.       Deputy Registration            Or Call: (081) 959 3377
  418.       S/E/G Communications               Fax: (081) 959 2137
  419.       137 Hale Lane
  420.       Edgware                  International: + 44 81 959 3377
  421.       Middx HA8 9QP                      Fax: + 44 81 959 2137
  422.       United Kingdom              Email: segcom@cix.compulink.co.uk
  423.                              Compuserve: 100111,3165@compuserve.com
  424.  WE REALLY DO VALUE YOUR OPINION. If you have comments or suggestions 
  425.  about Deputy, please let us know. Deputy is a user supported program.
  426.  Installation 
  427.  If    this    disc    was    provided   on   disc   directly   by
  428.  S/E/G Communications or from a software library then  follow  the
  429.  instructions  on  the  floppy  disc  to copy all the files into a
  430.  suitable directory.  Answer the questions when prompted  and  the
  431.  installation  process  should  then  complete automatically.
  432.  If this software was downloaded from a bulletin  board  or  other
  433.  online  system,  un-arc  or un-zip the files into a newly created
  434.  directory, e.g. C:\DEPUTY.
  435.  This archive should contain the following files:
  436.  README.EXE    - The Automatic brief guide to Deputy (this!)
  437.  DEPUTY.EXE    - The main executable file
  438.  SCREENST.TXT  - The login screen for the host mode
  439.  DEFAULT.HLP   - Help Data (One file for each language)
  440.  DEFAULT.LNG   - Language file (one for each language)
  441.  DEPUTY.CFG    - Configuration file (this file may be missing)
  442.  DEPUTY.DIR    - The Default dial directory
  443.  DEPUTY.MSG    - Default file for text editor (you can delete this)
  444.  DSLFILES.EXE  - Sample DSL source files (self-extracting, run it)
  445.  To start Deputy, change to its directory and type: 'DEPUTY <ENTER>'.
  446.  IMPORTANT NOTES FOR SHAREWARE VENDORS / BULLETIN BOARDS ETC. 
  447.  Vendors  of  shareware  discs  are  welcome to distribute the shareware
  448.  verion of Deputy in its complete form providing that they first  notify
  449.  S/E/G  that  they  intend doing so - this is so that we can keep you on
  450.  our database to ensure that you  always  have  the  latest  version  of
  451.  Deputy.   Such distribution is subject to all the normal terms shown in
  452.  the shareware licence elsewhere. Vendors may not charge more  than  
  453.  for   supplying   Deputy,   although  most  vendors charge considerably
  454.  less. It should be made clear to purchasers that they are not buying or
  455.  paying for the registration of the software; the fee they pay to you is
  456.  merely an  administration  and  distribution  charge.
  457.  Bulletin Boards and other online systems are also welcome to distribute
  458.  the shareware version of Deputy to their users in its complete form  as
  459.  long as no special charge is made for the distribution, other than your
  460.  normal connection/online charges.
  461.  Deputy  MAY  NOT  be supplied together with any other goods or services
  462.  without the written permission of S/E/G; for instance, Deputy  may  not
  463.  be  bundled  when  selling  modems. If you wish to do this, please call
  464.  S/E/G for clearance first.
  465.  SPECIAL MODEM OFFERS 
  466. Multitech MT1432MK V32bis Data/Fax Modem ONLY 
  467. 499 + VAT !!!
  468.   Fully  BABT  approved,  the  MT1432MK modem is a desktop/pocket
  469.   sized modem providing both 14400 bps V32bis data rate plus full
  470.   send and receive  fax  facilities,  available  now  at  a  very
  471.   special  offer  price of just 
  472. 499+VAT complete with all leads,
  473.   software, mains adaptor, carry case and battery.   Please  call
  474.   us for more details. Price subject to change without notice.
  475. Miracom Courier High Speed Modems - Low prices !
  476.   As  one  of  the most popular ranges in the the UK, the Miracom
  477.   Courier range is backed up by a full  5  year  warranty.  S/E/G
  478.   always  offer  very special prices on the complete range but as
  479.   special offers are always being offered, please call us for the
  480.   latest prices.
  481.   We  not  only  offer  excellent  prices,  we  are  always  here
  482.   afterwards  to  offer  you  after-sales support to help you use
  483.   your new modem. We can accept credit card  orders  which  means
  484.   that  you  can  usually  have  your  modem  the  next  day  (UK
  485.   Mainland). Call us on (UK) 081 959 3377.
  486.  Other Services from S/E/G 
  487.   MODEM SUPPLY
  488.   As well as being the producers of DEPUTY, S/E/G's other services
  489.   include the supply and support of modems. Whatever your current
  490.   requirements are, give S/E/G a call for the most competitive
  491.   prices on all popular brands including Miracom, Pace, Dowty,
  492.   Dataphone, Penril, Amber Logic, Racal and most other brands.
  493.   We supply modems for all applications; dialup or leased lines,
  494.   high security, encrypting modems, desktop, card, pocket and
  495.   rackmount modems, low speed modems and ultra-high speed modems.
  496.   We also supply combined fax-modems giving you the full
  497.   functionality of a high speed modem, coupled with the ability
  498.   to send and receive faxes to/from any other fax machine.
  499.   LAN INSTALLATION / SUPPORT
  500.   Our team of trained LAN experts will be happy to advise you on
  501.   your LAN requirements. Specialising in Novell Netware, we can
  502.   supply and install the latest LAN technology using your choice
  503.   of topologies and operating systems. As well as the supply, we
  504.   offer comprehensive support services for both new and existing
  505.   LAN's, so if you already have a LAN which needs upgrading or
  506.   just simply 'looking after', it is worth talking to us.
  507.  Customised Software From S/E/G 
  508.    DEPUTY DEVELOPERS EDITION
  509.    A  special  version is available of Deputy which compiled DSL
  510.    source files into standalone executable files. These compiled
  511.    DSL executables may be freely distributed or  resold  without
  512.    further  payment  to  S/E/G.  For details on 'Deputy Runtime'
  513.    please contact S/E/G - it is available to special order only.
  514.    CUSTOMISED DEPUTY
  515.    Deputy was designed to be suitable for many comms requirements
  516.    but sometimes, you require just a little bit, or even a lot of
  517.    customisation to make a program more suitable for your needs.
  518.    S/E/G can produce customised versions of Deputy for specific
  519.    applications; this costs a lot less than you might imagine, so
  520.    please don't hesiate to call us to discuss the possibilities.
  521.    BESPOKE SYSTEMS
  522.    As well as communications  software,  S/E/G  produces  varied
  523.    bespoke software for clients. If you have a requirement for a
  524.    software  package, or complete suite of software, our team of
  525.    programmers can produce quality  software  products  quickly,
  526.    efficients  and  reliably.  Again,  please  give us a call to
  527.    discuss your requirements.
  528.  ** HELP IS ALWAYS AVAILABLE WITHIN DEPUTY BY PRESSING ALT-F1 **
  529.  This  shareware  version  of  the manual assumes that you have a
  530.  'basic' knowledge of  comms  principles;  being  somewhat  of  a
  531.  potential  minefield, this guide would soon become three volumes
  532.  thick if we attempted to unravel comms  for  everyone.
  533.  Remember that this manual is only a very brief intruction guide;
  534.  when you register Deputy, you receive the  full  printed  manual
  535.  which covers everything in much greater depth.
  536.  If this is the first time you have run Deputy, it probably won't
  537.  be  configured.   As  such, it will immediately ask you the most
  538.  important setup options; the screen you  are  using  (colour  or
  539.  mono) and to which port your modem is connected to (e.g. COM1).
  540.  If this version of Deputy has come with any language files, then
  541.  you will also be asked which langauage you wish to use.
  542.  When  Deputy  loads,  after the shareware notice, you are placed
  543.  into in terminal mode, in the default emulation. Of course, when
  544.  you register Deputy, you receive a verison of Deputy without the
  545.  shareware reminder screens. You can immediately start talking to
  546.  your modem with 'Hayes' AT commands from this position.
  547.  The  line  at the bottom of the screen is the STATUS LINE.  This
  548.  gives you information about the current status of  the  software
  549.  and  your  modem.  It  should look something like the first line
  550.  shown below; each item is annotated:
  551.  Deputy 
  552.  DCD CTS 
  553.  No Log 
  554.  9600 NORM 
  555.  TTY   
  556.  000 
  557.   00:00   0
  558.        
  559.       
  560.        
  561.       
  562.        
  563.        
  564.      
  565.        
  566.       
  567.        
  568.       
  569.        
  570.      
  571.        
  572.       
  573.        
  574.       
  575.  Call Cost 
  576.      
  577.        
  578.       
  579.        
  580.       
  581.   Time online 
  582.      
  583.        
  584.       
  585.        
  586.       
  587.      RX speedometer 
  588.        
  589.       
  590.        
  591.       
  592.  Terminal Emulation
  593.        
  594.       
  595.        
  596.  MNP mode (MNP2, MNP4, MNP5)
  597.        
  598.       
  599.        
  600.  COM speed (300-115200 bps)
  601.        
  602.       
  603.  Name of open log file (if any)
  604.        
  605.  Status of RS232 'CTS' (clear to send) line
  606.        
  607.  Status of RS232 'DCD' (carrier detect) line
  608.  Name of currently active script (if any)
  609.  The  two  RS232 status indicators DCD and CTS are displayed when
  610.  true (or highon) and are blank when false (lowoff). If there  is
  611.  no  active  script  (see  later), then that space is occupied by
  612.  "Deputy" as shown above. Call cost is  shown  in  pence  and  is
  613.  active  only  when  the  optional  external call cost program is
  614.  used.
  615.  Pressing Alt-M in terminal mode will bring up Deputy's main  bar
  616.  menu.   From  here,  you  can  select  most  Deputy functions by
  617.  selecting the appropriate option.  Each option on the  bar  menu
  618.  will  bring up a corresponding sub-menu - you can press the left
  619.  or right arrows to move to the next menu along.
  620.  Alternatively,  most menus can be brought up instantly by use of
  621.  hot-keys.  These are shown on the main menu; for instance  "Dial
  622.  Directory  ALT-N".   This  means  that  to  call  up the dialing
  623.  directory, you press <N> whilst holding down the <ALT> key.
  624.  If this is the first time you are running Deputy, then  various
  625.  preferences  can  now  be set, in addition to those already set.
  626.  From the main Menu select setup.  As mentioned  previously,  you
  627.  can alternatively bring up the setup menu by pressing Alt-S; see
  628.  the next section 'SETTING UP DEPUTY'.
  629.   *** REMEMBER: MENU WINDOWS CAN BE SHIFTED AROUND THE SCREEN **
  630.    *** BY PRESSING CTRL-LEFT/CTRL-RIGHT OR CTRL-UP/CTRL-DOWN ***
  631.  The setup menu (Alt-S or 'S' from the main menu) enables  to  to
  632.  customise   Deputy   to  both  your  system  and  your  personal
  633.  preferences. The menu looks like this:
  634.        S - Serial
  635.        M - Modem Control
  636.        E - Emulation
  637.        F - File Transfer
  638.        S - Screen Setup
  639.        A - Macro Setup
  640.        H - Host Setup
  641.        U - Miscellaneous
  642.        S - Save Options
  643.       Each option will bring up its own 'sub-menu' as follows:
  644.       S - Serial
  645.         This   option   allows  you  to  select  all  of  your  default
  646.         communications parameters.  These may need to  be  altered  for
  647.         different  services,  so they can also be set for each entry in
  648.         the dialing directory (see section  10).  The  options  are  as
  649.         follows:
  650.         PORT:  This  selects the COM or Serial port to which your modem
  651.         is connected. Often it will be COM1, but if your  computer  has
  652.         more  than  one COM port, you may have another peripheral, such
  653.         as  a  mouse,  connected to COM1, in which case, select and use
  654.         COM2 for your modem.
  655.         BAUD: The term 'Baud' is actually deliberately misused here; in
  656.         this context we actually mean Bits Per Second  (BPS)  and  this
  657.         refers  the  speed  of communication between the modem and your
  658.         computer.  This should be set to the highest line speed of your
  659.         modem  (eg  2400),  however,  if  your  modem   supports   data
  660.         compression,  the  Baud  Rate setting should be doubled or even
  661.         trippled if you are using V42bis.  Refer to your  modem  manual
  662.         for recommendations.
  663.         PARITY:  This  option  controls  not only the data parity (odd,
  664.         even or none), but also the byte length (7 or 8 bits). All data
  665.         types supported have only one stop bit.  For  most  systems,  a
  666.         setting  of 8N1 is required but there are various systems which
  667.         support 7 bit data, normally requiring a  setting  of  7E1;  in
  668.         particular viewdata or 'Prestel' type systems use 7E1 data.
  669.         STRIPT PARITY & CHECK PARITY: These two  options  are  normally
  670.         only  useful  in special cimcumstances. They allow you to strip
  671.         the 8th bit from each byte (Binary 'AND' with 127) and  discard
  672.         bytes whose parity is incorrect, respectively.
  673.         RTS/CTS: This controls 'hardware flow control' and is desirable
  674.         wherever  possible,  assuming  that your modem supports it; you
  675.         may have to enable it  on  your  modem  with  a  command.  Flow
  676.         control  ensures  that the modem and computer only receive data
  677.         when they are ready to handle it. RTS and CTS are  two  control
  678.         lines which form part of the modem cable.
  679.         XON/XOFF:  This  controls 'software flow control' and is useful
  680.         where RTS/CTS flow control cannot be used. Instead of  toggling
  681.         the  RTS/CTS  lines,  an XOFF code is sent to request that data
  682.         flow stops followed by an XON code to resume. Again,  this  may
  683.         also need to be enabled on your modem.
  684.         MNP:  Deputy's  MNP  Level  5 emulation is covered in detail in
  685.         section 7. This option allows you to set the level  of  service
  686.         that you require: None, Level 4, Level 5 or Auto, in which case
  687.         Deputy will attempt to establish the highest level possible.
  688.       M - Modem Control
  689.         This  option allows you to alter the commands which Deputy uses
  690.         to for control your modem.
  691.         PREDIAL COMMAND: This setting is often left blank but  can  can
  692.         be  a  command  to  enable  a particular feature, such as error
  693.         correction,  on  your  modem.   A  Carriage  Return   <CR>   is
  694.         automatically sent after the command.
  695.         DIAL COMMAND: On a 'Hayes compatible' modem, the  Dial  command
  696.         is  almost  always  ATD  but can be suffixed by a 'T' or 'P' to
  697.         select tone or  pulse  dialing. If you are on an internal PABX,
  698.         you  may also want to add an 9 followed by a comma to select an
  699.         outside line. eg ATDT9,
  700.         PRE-HOST and POST-HOST COMMANDS: These are the commands used by
  701.         Deputy's Host Mode to enable and disable auto-answering on your
  702.         modem.  These are normally ATS0=1 and ATS0=0 respectively.
  703.         DIAL TIMEOUT: This sets the length of time that  Deputy  allows
  704.         for  a  call  to connect before reporting no answer. A sensible
  705.         setting is 60 seconds; your modem may have its own timer.  If a
  706.         number is engaged, the attempt will abort immediately.
  707.         DTR DISC: Some modems do not drop the line in response to DTR
  708.         dropping, particularly  if  you  are using a non-standard modem
  709.         cable. This option allows you to enable the Hayes (tm) Standard
  710.         method for dropping the line by issuing the +++ escape sequence
  711.         followed by the ATH0 command.
  712.         ROUTING  ID:  Users  in the UK may have access to a Mercury 2300
  713.         account, whereby calls may be routed via Mercury. If you have  a
  714.         Mercury  account,  then you can enter your 10 digit ID code plus
  715.         any cost centre digits  here.   You  than  then  select  Mercury
  716.         routing  from  within  the dial directory (see section 10).  For
  717.         security purposes, you cannot display your Mercury ID,  it  will
  718.         be shows as a series of asterisks.
  719.       E - Emulation
  720.         This option allows you to select the default terminal emulation
  721.         for Deputy.  Current emulations supported are  TTY  (Teletype),
  722.         VT52, VT100/102, VT200, VT320, ANSI, PRESTEL and WY60 (Wyse 60)
  723.       F - File Transfer
  724.         This controls various options with regard to File Transfer:
  725.         DOWNLOAD  DIR:  This  option  allows  you  to set the drive and
  726.         directory where  downloaded  files  are  to  be  saved.  If  no
  727.         directory is set, then downloads will be saved into the current
  728.         directory.
  729.         AUTO ZMODEM: This will enable Deputy to automatically  start  a
  730.         Zmodem  download  when  it sees the standard Zmodem header from
  731.         the remote system.
  732.         AUTO CIS: For users of the Compuserve conferencing system, this
  733.         option  will enable  downloads to start automatically using the
  734.         'Compuserve B' file transfer protocol.
  735.         EXISTING  FILES:  If  you  try to download a file which already
  736.         exists on your computer then there are  various  actions  which
  737.         Deputy  can  take:  overwrite, abort, rename the file or to ask
  738.         you each time, which is the most flexible option.  In addition,
  739.         if  you  are using Zmodem, you also have the option to resume a
  740.         previously    interrupted    file    transfer    which    saves
  741.         retransmitting the whole file in full.
  742.         RENAME: Under some circumstances, you may wish to always change
  743.         the filename of downloaded files. If you  enable  this  option,
  744.         you will be prompted for a new filename at every download.
  745.         ABORTED FILES: This determines the action that Deputy will take
  746.         if  a  download is interrupted for any reason.  There are three
  747.         options: Delete the part-file, keep it, or ask you  each  time.
  748.         If  you  are  using  Zmodem,  then interrupted downloads can be
  749.         restarted so it is worth keeping the part-file.
  750.         FORCE NAME: Although unlikely, under some circumstance, you may
  751.         wish  to set the filename under which all downloads are stored.
  752.         To do this, enter the name under this option. Bear in mind that
  753.         you are likely to get continuous reminders that the file exists
  754.         if you try to download more files.
  755.         SUCCESS  SOUND: Whilst a download is in progress, you may often
  756.         leave the computer and do something else. Enabling the  Success
  757.         Sound will make Deputy sound a pleasant warble noise to let you
  758.         you know that a file transfer has completed.
  759.         EXTERNAL  UPLOAD  &  DOWNLOAD:  Deputy provides seven different
  760.         file transfer protocols, however there  may  be  a  specialised
  761.         protocol which you wish to use which is provided by an external
  762.         program. These two options allow you to  specify  the  filename
  763.         and  command  line syntax for uploading or downloading using an
  764.         external program.   Full  pathnames  should  be  specified,  if
  765.         applicable.
  766.       C - Screen Setup
  767.         WRAP: Under some terminal  emulations,  when  the  cursor
  768.         reaches  the  end of the line, it should move down to the
  769.         start of the next line.   However,  should  you  wish  to
  770.         inhibit  this,  disabling  WRAP will cause all characters
  771.         received after column 79 to be  lost,  until  a  carriage
  772.         return  is  received.  Most  systems  which you call will
  773.         never allow column 79 to be reached  without  a  Carriage
  774.         Return anyway, so WRAP will most often be unimportant.
  775.         STATUSLINE: This enables or disables Deputy's Status Line
  776.         which is normally diaplayed at the bottom of the screen.
  777.         SHADOWS:  The  shadows  cast  by  pop-up  windows  can be
  778.         disabled by using this option.
  779.         SCREEN MODES: This option applied to EGAVGA screens  only
  780.         and  allows  you  to  select the screen mode; 25,43 or 50
  781.         lines. EGA screens should use 43 lines, whilst VGA should
  782.         use 50 lines.
  783.         SCREEN  SAVER:  For  both  privacy  and  reducing  screen
  784.         burn-in,  it  is  often  desirable to dim a static screen
  785.         display.  Enabling Deputy's Screen  Saver  will  dim  the
  786.         screen after a preset time of inactivity.  Time should be
  787.         entered  in  seconds.   This  facility should not be used
  788.         with multi-tasking enviroments.
  789.         COLOURS:   The   'Colours'   option   may    take    some
  790.         experimenting.  It  allows  you  to  completely customize
  791.         every aspect of the Deputy colour  scheme.   Colours  are
  792.         refered  to  by number. When you select each item, a grid
  793.         is displayed  showing  you  all  available  colours.  For
  794.         instance,  if  you  want  to select yellow on red for the
  795.         status line you would enter '78'.  As  well  as  allowing
  796.         you  to  select COLOUR, BLACK & WHITE or MONOCHROME mode,
  797.         the following colours can be changed:
  798.         Mainscreen  - The default colour of the main terminal screen
  799.         Statusline  - The colour of the status line at the bottom
  800.         Menuframe   - The colour of the frame which borders menus
  801.         Menutext    - Normal text within menu frames
  802.         MenuSelect  - The highlighted item on a menu
  803.         Fileinfo    - File information on the filetransfer window
  804.         FileinfoFr  - Frame colour of the file transfer window
  805.         Prompt      - Colour of static promptslabels within windows
  806.         Error       - Any error messages which may occur
  807.         Errorframe  - The frame around any error messages
  808.         Progressbar - The progress bar in the file transfer window
  809.         BLOCK CURSOR: By default, Deputy  uses  a  blinking  line
  810.         cursor; this option gives you a flashing block instead.
  811.         CHARACTER   SET:  When  in  VT320  mode,  this  selection
  812.         determines which international character set is used.
  813.       A - Macros
  814.         Deputy  allows  you  to  set  up to ten Macros; these are
  815.         words or strings which you may regularly need to type. By
  816.         programming the Macros, you can send  them  automatically
  817.         by  pressing  function keys F1 to F10. Select this option
  818.         to edit them. You  can  insert  control  codes  into  the
  819.         macros  by  quoting  them  as  three digit octal numbers,
  820.         preceeded by a reverse oblique: e.g. \007
  821.       H - Host mode setup
  822.         Deputy has a  sophisticated  host  mode  function.   This
  823.         option allows you to set normal and privileged passwords.
  824.         Full details on the host mode are given in section 12.
  825.       M - Miscellaneous
  826.       This menu option controls various functions:
  827.         RAW  LOGGING:  When you are logging incoming text to disc
  828.         (see section 10), then Deputy  will  normally  strip  all
  829.         control codes (VT100, ANSI etc.) so that the log contains
  830.         plain text.  If you require the file to include all bytes
  831.         received including control codes then enable Raw Logging.
  832.         LOCAL  ECHO:  If the system you are connected to does not
  833.         echo what you type, enabling Local Echo will  enable  you
  834.         to  see what you are typing - this can be useful when you
  835.         are communicating with someone else using Deputy.
  836.         REMOTE  ECHO  will  force  all  text   received   to   be
  837.         immediately  echoed back to the remote system; this could
  838.         also be useful when  communicating  with  another  Deputy
  839.         user.  Note:  If  you  have REMOTE ECHO enabled, then the
  840.         remote user should NOT have local echo enabled, and  vice
  841.         versa.
  842.         CR->CRLF:   Some  systems  do  not  send  linefeeds  with
  843.         carriage returns; if at the end of  a  received  line  of
  844.         text  the  cursor  moves to the start of the line but not
  845.         down a line, then enabling CR->CRLF IN should cure  this.
  846.         Similarly,  enabling  CR->CRLF  OUT will add linefeeds to
  847.         all carriage returns transmitted.
  848.         BS  DESTRUCTIVE: Normally, pressing the backspace key has
  849.         the effect  of  moving  back  a  space.   However,  under
  850.         certain  circumstances,  you  may  wish  the BS key to be
  851.         destructive, i.e.  move  back  a  space  and  remove  the
  852.         character at that position.
  853.         MARGIN  BELL:  For  some  systems  it may be useful to be
  854.         warned when your cursor approaches the end of a line.  If
  855.         this option is enabled, Deputy will 'beep' when you  pass
  856.         column 77 on the screen.
  857.         BUFFER  SIZE: Once text has scrolled up of the screen you
  858.         can still view it again by calling the Review Buffer with
  859.         Alt-R.  This  setting  defines  the  amount   of   memory
  860.         allocated to the review buffer.
  861.         NOVICE  MODE: If Novice Mode is selected, whenever Deputy
  862.         is not connected to a remote service, a  simple  to  use,
  863.         four  option  menu  will  appear  on  the  screen. If you
  864.         disable Deputy's Novice Mode, you  control  it  with  the
  865.         normal menus and hot-keys.
  866.         EDITOR  COMMAND:  Deputy  has  a  built  in  text  editor
  867.         allowing full manipulation of text (see  later  section).
  868.         You  may,  however,  prefer  a  different,  external text
  869.         editor such as Edlin.  By entering its filename here, the
  870.         external editor will be called in place of  the  internal
  871.         Deputy editor.
  872.         INACTIVITY   TIMEOUT:  This  facility  will  prevent  you
  873.         accidentally leaving your modem  online  and  running  up
  874.         phone  charges; if no data is sent or received for longer
  875.         that the time specified (in seconds),  then  Deputy  will
  876.         hang  up the line.  Time is entered in seconds and counts
  877.         from that time that the last data was receivedtransmitted
  878.         or a key pressed.
  879.       O - Save Options
  880.         Once you have set up  your  preferences,  you  must  save
  881.         them  to  the config file if you want these options to be
  882.         retained  when  you  exit  Deputy,  otherwise  they   are
  883.         temporary  only.   Selecting  this  option  will save the
  884.         config file.
  885.  As mentioned previously, pressing Alt-M from terminal mode  will
  886.  bring  up  Deputy's main menu. From here, you can select most of
  887.  Deputy's other functions. In most cases, you can bypass the main
  888.  menu and initiate each option instantly  with  the  hot-keys  by
  889.  pressing  the key combination shown on the right of each option.
  890.  The main bar menu's options are as follows:
  891.  FILE   SCRIPT  MAIN   DIAL   SETUP  DOWNLOAD  UPLOAD  EXIT   HELP
  892.  The file menu (Press Alt-F) will being up these option:
  893.     O - DOS       - Shell to DOS, but remain online.
  894.     X - Exit      - Leave Deputy altogether
  895.     L - Logging   - Turn logging on or off
  896.     P - Printer   - Turn the printer on or off
  897.     D - Directory - View a disc directory
  898.  The  SCRIPT  menu  brings up a list of available scripts, either
  899.  compiled or not compiled. The MAIN menu displays  commonly  used
  900.  functions  of  Deputy  such  as 'clear screen' and 'hangup'. The
  901.  DIAL option will bring up Deputy's dial  directory  which  holds
  902.  details of the services you wish to call.
  903.  By  far  the  most  significant  feature  of   Deputy   is   the
  904.  implementation of MNP5. This is the most common error correction
  905.  system  currently  in  use  and ensures clean data and increased
  906.  data speeds.  Many modems support MNP5  themselves,  but  Deputy
  907.  allows you to add MNP5 to any modem.
  908.  There are five levels of MNP - Deputy supports levels 2,4 and 5.
  909.  Levels  4  and below are error correction levels which packetise
  910.  data and add CRC (checksums) before transfer.  This enables  the
  911.  receiving  system to test the integrity of the received data and
  912.  to request a re-send if it was  corrupted  in  transit  (due  to
  913.  line-noise  or  other  interference).   This  whole  process  is
  914.  automatic and completely transparent to the user - all  you  see
  915.  is clean data, no matter how bad the line is.
  916.  MNP  level  5  adds data compression to the lower levels; before
  917.  the packets are transferred, complex compression algorithms  are
  918.  applied  to the data which can achieve a compression ratio of up
  919.  to 2:1, effectively halving your online time.   The  compression
  920.  efficiency  is heavily dependant on the data being sentreceived;
  921.  MNP5 works best on plain ascii  text  and  will  work  worst  on
  922.  pre-compressed  files (eg .ARC or .ZIP files). In fact, MNP5 can
  923.  add a time overhead if you  are  transferring  ready  compressed
  924.  files,  therefore  it  may  be  advisable to limit Deputy to MNP
  925.  level 4 for file transfers.
  926.  To enable MNP, select it  from  the  'SERIAL  SETUP'  menu;  the
  927.  options  are  MNP2,  MNP4,  MNP5, None or Auto.  In 'Auto' mode,
  928.  Deputy will attempt  to  establish  MNP  in  the  highest  level
  929.  possible,  or  normal  (uncorrected)  mode  if  the remote modem
  930.  doesn't support MNP.  MNP level 4 is also  compatible  with  the
  931.  CCITT  V42  error correction standard. An MNP connection will be
  932.  attempted every time your modem connects to a remote system.
  933.  Pressing Alt-I during  a  call  will  pop  up  a  window  giving
  934.  statistics   on  the  error  correction  currently  in  use,  as
  935.  appropriate. This is useful for checking line quality.
  936.  One of the most common  functions  of  comms  software  is  file
  937.  transfer; uploading (sending a file) or downloading (receiving a
  938.  file).   There   are   several   protocols  in  common  use  for
  939.  transferring files, each with varying  efficiencies.   The  most
  940.  efficient  protocols  are Zmodem and YmodemG, although Zmodem is
  941.  by far the most flexible as it allows  you  to  restart  aborted
  942.  transfers  from the point at which they were interrupted, rather
  943.  than  having  to  resend  the  whole  file.   Deputy  can   also
  944.  automatically start Zmodem downloads.
  945.  NOTE:  FILE TRANSFERS ARE ALWAYS IN THE BACKGROUND. You can drop
  946.  to DOS or use Deputy's other features such as  the  text  editor
  947.  whilst the download proceeds in the background.
  948.  Deputy currently supports the following file transfer protocols:
  949.  Xmodem,  Ymodem,  YmodemG,  Zmodem,  Kermit and ASCII (where the
  950.  file is sent in raw form without headers for simple  capture  at
  951.  the  receiving  end).  By using an external program, you can add
  952.  oyur own file transfer protocols to Deputy.
  953.  Uploading procedures vary according to the system which you  are
  954.  dialled  into,  but  when  you are prompted to start sending the
  955.  file, press ALT-U, PageUp or select 'U' from the main  menu  and
  956.  then select the protocol as prompted.  You will then be prompted
  957.  for  the  filename  of  the file which you wish to send; you can
  958.  include  drive  designations  and  pathnames.   To  display  the
  959.  contents  of  a  directory, press Alt-F, select 'directory', and
  960.  enter the pathname and the search pattern  (e.g.   c:*.*).   You
  961.  can also bring up this directory by entering a wildcard instaead
  962.  of an upload filename.
  963.  Downloading  is  started  by  pressing  Alt-D,  PageDown  or  by
  964.  selecting 'D' from the main menu. If you are using  Zmodem,  and
  965.  'AutoDownload'  has  been enabled on the setup menu, then you do
  966.  not need to start the download -  Deputy  will  see  the  Zmodem
  967.  ehaders and automatically start the download.
  968.  If you try to download a file which already exists on your disc,
  969.  Deputy  can take several different actions, depending on the way
  970.  you set it up on the 'File Transfer' setup menu; options include
  971.  restarting aborted downloads.  With any protocol,  if  you  have
  972.  enabled  'Rename',  then you will always be prompted to enter an
  973.  alternative filename.  When  you  are  transferring  files,  the
  974.  progress  bar  in  the centre of the transfer window gives you a
  975.  quick visual indication of progress. An 'alarm' will  sound  (if
  976.  enabled) to indicate completion of a file transfer.
  977.  On  the  download and upload menus, you will also find an option
  978.  labelled "History".  Selecting this will display a full  listing
  979.  of all files transferred successfully.
  980.  Deputy contains its own built in Wordstar (tm) compatible  text
  981.  editor.  It is easy to use and allows you to edit text files and
  982.  includes various features for text manipulation.
  983.  The  Editor  is  also used to display the review buffer; as such
  984.  you can edit and save to disc any text contained in  the  review
  985.  buffer.   To  invoke the editor in its own right, press Alt-E or
  986.  select 'Editor' from the main menu (Alt-M).  The Editor takes up
  987.  half of the screen, but you can enlarge it to the full screen by
  988.  pressing <F5>.  Pressing <F5>  again  shrinks  it  back  to  its
  989.  original size.
  990.  The  filename  of  the  current  file is shown on the top status
  991.  line, together with other useful information.   To  load  a  new
  992.  file,  press  F3  and enter the filename along with any relevant
  993.  pathnames.  To save the current file, press <F2>.
  994.  The normal keyboard editing keys are all available (cursor keys,
  995.  Pageup, Ins etc.).  The following commands are available  within
  996.  the text editor:
  997.          Cursor Movement                    Block Commands
  998.     LEFT or ^S - Character Left     F7 or ^KB - Mark Beginning
  999.    RIGHT or ^D - Character Right    F8 or ^KK - Mark End
  1000.       UP or ^E - Character Up             ^KC - Copy Block
  1001.     DOWN or ^X - Character Down           ^KV - Move Block
  1002.    ^LEFT or ^A - Word Left                ^KY - Delete Block
  1003.   ^RIGHT or ^F - Word Right               ^KW - Write Block
  1004.             ^W - Scroll Up                ^KR - Read Block
  1005.             ^Z - Scroll Down              ^KP - Print Block
  1006.     PgUp or ^R - Page Up                  ^KT - Transmit Block
  1007.     PgDn or ^C - Page Down
  1008.    Home or ^QS - Start of Line            ^QB - Find Block
  1009.     End or ^QD - End of Line              ^QK - Find Block End
  1010.   ^Home or ^QE - Top of Screen            Ins - Insert/Overwrite
  1011.    ^End or ^QX - Bottom of Screen          ^N - Insert Line
  1012.   ^PgUp or ^QR - Start of File             ^M - Insert Line
  1013.   ^PgDn or ^QC - End of File        Tab or ^I - Insert Tab
  1014.                                            ^B - Reformat paragraph
  1015.                                     Del or ^G - Delete Character
  1016.            F2 - Save file                  ^H - Delete Char. Left
  1017.           ^F2 - Save file as               ^T - Delete Word
  1018.            F3 - Load file                  ^Y - Delete Line
  1019.           F10 - Swap position             ^QY - Del. rest of line
  1020.            F9 - COMPILE .DSL            Alt-J - Justify on/off
  1021.            F5 - Zoom in/out
  1022.  The Dial Directory  provides  a  convenient  method  of  storing
  1023.  details  of the services which you regularly call.  Each service
  1024.  has its own entry  detailing  service  name,  number  and  setup
  1025.  information.
  1026.  To open up the dialing directory, select <N> from the main menu,
  1027.  or press Alt-N from terminal mode. The first 15 entries  in  the
  1028.  directory will be shown; if this is the first time you have used
  1029.  Deputy, then the entires will be mostly blank.  The entries will
  1030.  look something like this:
  1031.       
  1032.       
  1033.  Service Name     
  1034.  Key     
  1035.  Phone Number            
  1036.       
  1037.       
  1038.  Fred's System    
  1039.  Fred    
  1040.  011 555 1234            
  1041.       
  1042.  Cix (V32)        
  1043.  Cix     
  1044.  081 390 9800            
  1045.       
  1046.  Cix (V22bis)     
  1047.  Cix2    
  1048.  081 390 1244            
  1049.       
  1050.  Bix (USA)        
  1051.  Bix     
  1052.  M 0101 (617) 861 9767   
  1053.       
  1054.                   
  1055.          
  1056.                          
  1057.       
  1058.  The  cursor keys can move up or down the directory. If there is
  1059.  an entry already set up with a service which you wish  to  call,
  1060.  move to that entry and press <ENTER>. It will then dial.
  1061.  To  edit an existing or blank entry, move to it using the cursor
  1062.  keys and press <F2>. To add a new entry, press <F4>.   A  window
  1063.  will pop up showing the settings for that entry, as follows:
  1064.  Service              Cix 
  1065.  - The service name
  1066.  Key                  Cix 
  1067.  - A 'key' for reference
  1068.  Number        0813995252 
  1069.  - The full telephone number
  1070.  Speed              DEFLT 
  1071.  - Setting for the DTE speed
  1072.  Parity               8N1 
  1073.  - Data type: parity & length
  1074.  Strip Parity       DEFLT 
  1075.  - Strip the 8th bit of each byte
  1076.  MNP                DEFLT 
  1077.  - Use Deputy's built in MNP
  1078.  Emulation           ANSI 
  1079.  - Terminal Emulation
  1080.  ModemCmd           AT\N3 
  1081.  - Additional command for your modem
  1082.  Macros             DEFLT 
  1083.  - Specific macro script
  1084.  Logfile            DEFLT 
  1085.  - Name of service specific logfile
  1086.  Script           CIX.SCR 
  1087.  - Script to run after connection
  1088.  DownloadDir        DEFLT 
  1089.  - Where to store downloaded files
  1090.  Tie                 CIX2 
  1091.  - Alternative entry (see 'key')
  1092.  Retries            DEFLT 
  1093.  - No. of attempts before aborting
  1094.  Timeout            DEFLT 
  1095.  - Time before aborting dial attempt
  1096.  Most of the entries will not need altering;  assuming  that  you
  1097.  have  set  up  Deputy  correctly,  the  DEFAULT  values  will be
  1098.  adequate.  As a minimum, you  must  set  the  service  name  and
  1099.  number. To alter each item, move to it using the cursor keys and
  1100.  press <Enter>.
  1101.  Many  public  services  have  several  telephone numbers; if one
  1102.  number is engaged or unavailable, you  can  instruct  Deputy  to
  1103.  automatically  try  an alternative number. To do this, enter the
  1104.  second number as a separate entry and give it a 'Key' in the key
  1105.  field. Then enter that 'Key' into the 'Tie' field of  the  first
  1106.  number.   If  you  set  the retries field, then the first number
  1107.  will be retried before trying the second number.
  1108.  Deputy  keeps  records  of  use  for  each  entry in the Dialing
  1109.  Directory.  Pressing <F5> will display the  statistics  for  any
  1110.  entry,  including  usage details (data volumes, number of calls,
  1111.  last call etc. . Pressing <F6> will display the  complete  usage
  1112.  history of the dial directory showing all calls made.
  1113.  Brackets,  dashes  and  spaces  can  be  used  to make telephone
  1114.  numbers more readable; these are ignored  by  the  dialler.   eg
  1115.  '(0123)   456789'   or   '0123-456789'.    Commas   are  usually
  1116.  interpreted as a pause, but this  may  vary  depending  on  your
  1117.  modem. You can also include any iof your defined DIAL MACROS  in
  1118.  the  number,  for  instance:  @1 712 1234 where @1 is defined as
  1119.  '9, 0101 213' under the 'modem control setup' menu.
  1120.  The MACRO field can contain the name of a  compiled  DSL  script
  1121.  which uses the MAPKEY command to define the F1-F12 keys. See the
  1122.  chapter on script files for more details.
  1123.  The  script  field should contain details of an automatic script
  1124.  to be run immediately after connection; see  the  later  section
  1125.  for full details  on  scripts.  Note  that  normally,  the  dial
  1126.  directory  is called FROM a script in which case this field must
  1127.  be left blank to prevent an endless loop.
  1128.  If  you  require  a record of all online 'transactions' then you
  1129.  can set up a logging  file  name;  all  text  received  for  the
  1130.  duration  of  the  call  will  be  logged  to that file.  If the
  1131.  logfile already exists from a previous call, new  data  will  be
  1132.  appended   to   the   end.  Beware,  unmaintained  logfiles  can
  1133.  potentially become very big!
  1134.  Mercury Users: UK users who wish  to  access  the  Mercury  2300
  1135.  service  can  do  so  by  adding the prefix 'M' to the telephone
  1136.  number string, as shown in the above table on the  third  entry.
  1137.  Your Mercury id can be setup from the setup menu on Alt-S or <S>
  1138.  from  the  main menu. This assumes that the Mercury 2200 service
  1139.  is available in your area and that you have a valid account.
  1140.  Logging allows you to save all text received directly to a  file
  1141.  as well as displaying it on screen. To start logging, select <L>
  1142.  from the main menu, or simply press Alt-L. You will be asked for
  1143.  a  filename  to  save  the log under which can include paths. To
  1144.  stop logging and close  the  file,  press  Alt-L  again.  Whilst
  1145.  logging is operating, the filename is shown on the status line.
  1146.  Some  services  which  you  may call may have a 'real time' chat
  1147.  facility. Chat mode separates incoming text from  outgoing  text
  1148.  so that what you are writing isn't interrupted by a sudden burst
  1149.  of  incoming  text. To enter chat mode, select <Y> from the main
  1150.  menu. To return to normal terminal mode, press <ESC>.
  1151.  Review allows you to scroll 'back up the page' to see text which
  1152.  may have scrolled off the top of the screen.   Review  uses  the
  1153.  standard  text editor so text can be edited, printed or saved to
  1154.  disc (see section 6). To enter the review  editor,  press  Alt-R
  1155.  from the main terminal screen or press 'R' from the main menu.
  1156.  You  can  clear  the  screen  at  any  time by pressing Alt-W or
  1157.  selecting <W> from the main menu. If you need to drop to DOS for
  1158.  any reason, you can do this by pressing <O> from the  Main  Menu
  1159.  or   Alt-O.    If  you  require a directory listing, then select
  1160.  DIRECTORY from the file menu (Alt-F).
  1161.  There  may  be various keypress sequences which you need to send
  1162.  regularly; by programming Deputy's macros,  you  can  send  them
  1163.  quickly by pressing the Macro keys: F1 to F12. The macros can be
  1164.  set from the setup menu.
  1165.  One of the most common functions of modems is  for  transferring
  1166.  files  between  locations.  Deputy's host mode allows you to set
  1167.  your computer and modem  to  automatically  answer  and  process
  1168.  incoming  calls,  allowing  users  to send and receive files and
  1169.  also to leave messages, both public and private.   In  addition,
  1170.  authorized  people  can  remotely  drop down to DOS to carry out
  1171.  routine system maintainance.
  1172.  There is very little setting up required for the host mode; from
  1173.  the normal setup menu, MODEM CONTROL has two  settings  relevant
  1174.  to host mode which enable and disable auto-answer on your modem.
  1175.  Under the HOST MODE SETUP option, you can set passwords for both
  1176.  normal users and a Sysop (systems operator) - this is a security
  1177.  measure  to  prevent  unauthorised people accessing your system.
  1178.  Using this method, users are asked for a  user  id  (name)  when
  1179.  they  log in, but they can enter anything as their id. All users
  1180.  share the same password.
  1181.  To make your system more sophisticated, you can  create  a  user
  1182.  file containing a list of users and unique passwords. This means
  1183.  that  each  user  can  only log in under their own id. If a user
  1184.  file exists, then the 'normal user password'  becomes  inactive,
  1185.  although  the  Sysop Password is still available. You can create
  1186.  the user file using Deputy's built in editor, as follows:
  1187.  From normal terminal mode, press Alt-E to bring  up  the  editor
  1188.  and  then  press <F3> and type PASSWORD.TXT as the filename.  On
  1189.  each line, enter a  username  and  a  password,  with  as  space
  1190.  between  them.  You  can  add  as many usernamespasswords as you
  1191.  wish.  Here is an example:
  1192.        Freddie    Cola
  1193.        Jim        Wine     U
  1194.        Tony       Lemonade UD
  1195.        Joe_Smith  Coffee   UD
  1196.        Alan_Jones Tea      D
  1197.  Only a single space is required between words, but several  have
  1198.  been  used  for  clarity. The 'U' or 'D' (or both) after some of
  1199.  the names allow that user to either UPLOAD or DOWNLOAD files. If
  1200.  the flags are not set, then the user will  only  be  allowed  to
  1201.  read and post messages.
  1202.  To  start  up host mode, press Alt-A or select 'A' from Deputy's
  1203.  main menu. You are offered several further options:
  1204.    Enter Host Mode - Prepare to answer incoming calls.
  1205.    View messages - View the messages posted to the system.
  1206.    View Mail - View the User-to-User mail file
  1207.    View Activity - Shows details of who has called.
  1208.  NOTE: If you view the mail or public message files,  be  careful
  1209.  not to edit the headers as this could corrupt the message file.
  1210.  If  you  select  "ENTER HOST MODE" then the modem will be set to
  1211.  answer incoming calls. Deputy will display a message to indicate
  1212.  that it is ready to answer.
  1213.  The Deputy Host can be personalized; There are two special  host
  1214.  files  supplied  with  Deputy:  HOST.HLP  and SCREENST.TXT.  The
  1215.  first of these is the file displayed  when  callers  type  HELP;
  1216.  this  should  not need changing but you can alter if you want to
  1217.  give additional information or  personalise  the  message.   The
  1218.  second  file  (SCREENST.TXT)  is  a  plain  ASCII  file which is
  1219.  displayed as soon as a user  connects.   Normally  this  message
  1220.  would  contain  the  system name and a friendly welcome message;
  1221.  you can use the PC box character set to draw simple pictures. As
  1222.  usual, both of these files can be  edited  using  the  built  in
  1223.  Editor (Alt-E).
  1224.  Deputy  will  create three directories which the host mode uses.
  1225.  HOSTDIR is used to store usage  logs  and  message  files.   Two
  1226.  subdirectories  below HOSTDIR will also be created, called FILES
  1227.  and UPLOAD.  This is where you should put files for  callers  to
  1228.  download and where uploaded files will be stored, respectively.
  1229.  As a caller to the Deputy Host, operation is fairly simple.  The
  1230.  first screen you are presented with is the welcome message, held
  1231.  in the SCREENST.TXT file (see previous section). Following that,
  1232.  you  are  asked  for  your username and password.  You will have
  1233.  three attempts at each, resulting in disconnection if you do not
  1234.  enter a correct combination after that.
  1235.  Once you have completed the login procedure correctly, you  will
  1236.  be at the 'Read prompt' which is displayed thus: Read:
  1237.  The  host  is  controlled  using simple commands, rather than by
  1238.  menus - this makes it quick to operate once you are used to  the
  1239.  commands.   For  a listing and explanation of the commands, type
  1240.  'HELP' at the main prompt. The 'HOST.HLP' file will be displayed
  1241.  (see previous section). Something similar to the following  will
  1242.  display:
  1243.                   DEPUTY HOST MODE - ONLINE HELP
  1244.                   ------------------------------
  1245.      DIR <pattern>        Show files available for download
  1246.      UPLOAD               Send a file to the host computer
  1247.      DOWNLOAD <filename   Download the specified file
  1248.      TYPE <filename>      Output (text) file to screen
  1249.      BYE                  Disconnect - end your call
  1250.      SAY                  Post a public message
  1251.      MAIL                 Send User-to-User mail
  1252.      SHOWMAIL             Display private mail, addressed to you
  1253.      XMODEM               Select Xmodem as the default protocol
  1254.      YMODEM                 "    Ymodem  "  "     "       "
  1255.      ZMODEM                 "    Zmodem  "  "     "       "
  1256.      KERMIT                 "    Kermit  "  "     "       "
  1257.       Priviledged User Commands (Available to Sysop only):
  1258.      CD                   Change current file directory
  1259.      SHELL                Drop down to DOS shell
  1260.      EDIT <filename>      Edit file specified
  1261.  In  addition  to  these  commands,  pressing <ENTER> at the READ
  1262.  prompt will list the available public messages and  the  subject
  1263.  of  each.   If  you want to read any message, type the number of
  1264.  that message and press <ENTER>. If you want  to  post  your  own
  1265.  message, type SAY <ENTER>. You can then enter your message. When
  1266.  you  are  finished,  enter a single period on the line and press
  1267.  <ENTER>.
  1268.  As well as public messages, you  can  post  a  mail  message  to
  1269.  another  user,  in  privacy  - other callers will not be able to
  1270.  read the message. Type 'MAIL <CR>' and enter the recipients name
  1271.  when requested. Type your message as you would a public message,
  1272.  ending the message with a single period on  a  line.  Next  time
  1273.  that  user logs on, he will be informed of waiting private mail.
  1274.  To view private mail addressed to you, type SHOWMAIL.
  1275.  If you wish to download a file, you can view the available files
  1276.  by typing DIR, followed optionally by a search pattern -  if  no
  1277.  pattern  is given, it defaults to *.* (all files available).  To
  1278.  start the download, ensure you have selected your preferred file
  1279.  transfer protocol  (Xmodem,Ymodem,Zmodem  or  Kermit)  and  type
  1280.  DOWNLOAD  <filename>.   Then  start  your  own local download as
  1281.  required by your own  particular  software  (If  you  are  using
  1282.  Deputy  then  press  PageDown  to start a download).  NOTE: If a
  1283.  userlist file (password.txt) is being used, you must  have  your
  1284.  UPLOAD or DOWNLOAD flags enabled to be able to transfer files.
  1285.  Using  a  script  langauge  is  a  way  of  automating  Deputy's
  1286.  operation to enable functions to be carried  out  without  human
  1287.  intervention,  as  far  as possible. Most often, a simple script
  1288.  will  perform  a  task  such  as  sending  login  sequences  and
  1289.  passwords  automatically,  saving  you  from having to type them
  1290.  manually each time you call systems.
  1291.  A Deputy script, is a sequence of commands with a similar syntax
  1292.  to many other programming langauges.   There  are  two  ways  to
  1293.  create scripts with Deputy.
  1294.  1)  Using the SCRIPT LEARN command from the main menu, instructs
  1295.  Deputy to watch what you do  whilst  you  manually  log  onto  a
  1296.  system.  A  script is then automatically written which will copy
  1297.  exactly that sequence the next time you logon  to  that  system.
  1298.  This  method  is  very simple to use, without the user requiring
  1299.  any knowledge of the script langauge.
  1300.  2) By using the text editor to manually write a list of commands
  1301.  for Deputy to sequentially execute - this gives you the greatest
  1302.  flexibility and allows you access to the complete  command  set.
  1303.  Customisation   is   very   simple   but  this  method  requires
  1304.  substantially more work than method 1.
  1305.  NOTE: Deputy's script language (DSL) is  based  heavily  on  the
  1306.  Modula-2  command language, but due to historical reasons, there
  1307.  are also some deliberate similarities to the  language  provided
  1308.  by  Odyssey,  a  program  written  by  Don  Milne, also based on
  1309.  Modula-2, whom we hereby credit. It  should  be  noted  however,
  1310.  that  scripts  written for Odyssey will need considerable syntax
  1311.  and command translation to run under Deputy, and  vice-versa, as
  1312.  there are very few actual commands in common.
  1313.  Before  starting  the  learn  facility,  make sure that you have
  1314.  already added the service details to the dial directory (see the
  1315.  section on the dial directory).  Ensure that  the  entry  has  a
  1316.  'key'  entered  into  its  key field for the script to refer to.
  1317.  Make sure that you are out of  the  dial  directory,  in  normal
  1318.  terminal mode.
  1319.  Start the learn procedure by pressing Alt-M to bring up the main
  1320.  menu and then 'K'. Alternatively, press ALT-K from terminal mode
  1321.  which is the hot-key command for script learn. You will be asked
  1322.  to  enter  a  name  for  the  script  -  we suggest that you use
  1323.  something which relates to the entry if possible;  for  instance
  1324.  if  the  service  is  called  "Freddy's  System" call the script
  1325.  'Freddy' - that way it's easy to tell which entry  that  service
  1326.  belongs  to. The script name requires an extension .SCR - if you
  1327.  omit this, Deputy will add it automatically.  Press <ENTER>  and
  1328.  the  word  "LEARNING"  will  appear on the left hand side of the
  1329.  status line to indicate that Deputy is in LEARN MODE.
  1330.  Bring up the Dial Directory (Alt-N or 'N' from the  main  menu),
  1331.  move  to  the  relevant  entry  (previously  entered)  and press
  1332.  <ENTER> to select it. Deputy should now dial the number.
  1333.  Once connected, login to the system normally.   Deputy  will  be
  1334.  'watching  you'  and  will remember all of your keystrokes. Once
  1335.  you are logged in and want to stop script leaning, press  ESCAPE
  1336.  or Alt-K.
  1337.  To  test  the  script,  bring  up the dial directory (Alt-N) and
  1338.  select the entry.  The system should be dialled  and  the  login
  1339.  sequence, including your usernames and passwords should be typed
  1340.  automatically.  The script created (with a .DSL extension can be
  1341.  viewed and edited as if you had written it youself.
  1342.  NOTE:  If  an error occurs duing the learn sequence, such as the
  1343.  number being engaged or you making a typing  error,  you  should
  1344.  abort learning and restart from the beginning.
  1345.  PLEASE  REMEMBER:  Deputy's  script language is a highly complex
  1346.  programming enviroment; as such, the instructions here are  only
  1347.  intended to give you the bare essentials for writing scripts. It
  1348.  is  impossible  to  give  full  documentation in this file - the
  1349.  printed manual, which you receive when you register,  goes  into
  1350.  script  writing  in  very great depth with full command listings
  1351.  and examples.
  1352.  Deputy's   script  language  (DSL)  is  a  highly  sophisticated
  1353.  programming platform. The structure and syntax will be  familiar
  1354.  to  programmers  who  have  programmed in the MODULA 2 langauge.
  1355.  DSL is a compiled language; scripts, which can be written  using
  1356.  Deputy's  text editor, consist of a sequence of commands and are
  1357.  compiled before execution.
  1358.  A script file, before compilation, is known as the  source  file
  1359.  and  will usually has the extension ' .DSL '.  A compiled script
  1360.  file (also known as an executable script) has  the  extension  '
  1361.  .SCR'.   You can only edit and write .DSL files - files with the
  1362.  .SCR extension should be left alone.
  1363.  Scripts  are  run from the script menu, accessed either from the
  1364.  main menu or by pressing Alt-C.   This  menu  displays  all  DSL
  1365.  scripts,whether  compiled  or not - if you select a script which
  1366.  is not compiled then Deputy will automatically compile it before
  1367.  running it.  Similarly, if a source script  with  the  extension
  1368.  .DSL  has  a date which is newer than its corresponding compiled
  1369.  script, then the newer version is recompiled boefre executing.
  1370.  There are about 130 commands of which there are two basic types:
  1371.  Functions  and  Procedures.   Both  types  carry  out particular
  1372.  features, but functions return a Boolean result (i.e.   TRUE  or
  1373.  FALSE) after execution indicating the success or failure of that
  1374.  function.
  1375.  There  are several example scripts supplied with Deputy; examine
  1376.  these carefully in order to gain a full underatanding of how DSL
  1377.  works. The printed manual goes into much greater depth  than  is
  1378.  possible in this shareware manual.
  1379.  A  DSL  script  must start with the line ' SCRIPT scriptname; '.
  1380.  The main script body must be  contained  within  BEGIN  and  END
  1381.  commands; any variables required must be defined before the main
  1382.  script body (see 'variables' below). A semicolon must be used to
  1383.  terminate  all commands.
  1384.  NOTE:  Throughout  this  section,  various  script  examples are
  1385.  shown; the indentation used on each  line  is  optional  but  is
  1386.  commonly used by programmers to make scripts more readable.
  1387.  Variables
  1388.  A  variable  is  a  name  assigned  a to a particular numeric or
  1389.  boolean value. A variable name can  be  any  length  but  cannot
  1390.  share  the  same  name  as  a  function,  procedure or any other
  1391.  keyword. Any variables which you wish to use in a script must be
  1392.  defined at at the  start  of  the  script,  before  the  'BEGIN'
  1393.  command. The structure of the script will then be:
  1394.       SCRIPT test;
  1395.       VAR
  1396.       ok: BOOLEAN;
  1397.       time: INTEGER;
  1398.       (Any other variables to be defined here)
  1399.       BEGIN
  1400.       (main script body here)
  1401.       END.
  1402.  To assign a variable name to a value in DSL you use the  syntax:
  1403.  'varname  :=  expression  '  where varname is the name which you
  1404.  wish to assign the value to and 'expression' is any  numeric  or
  1405.  boolean  value.   As  well  as  assigning  a variable to a fixed
  1406.  values, you can assign a variable name the result of a function.
  1407.  Some examples follow:
  1408.  happy := TRUE         ( The variable 'happy' will be set to TRUE)
  1409.  cars  :=27            ( The variable 'cars' will be set to '27' )
  1410.  start := TIME()       ( The variable 'start' will store the result
  1411.                               of calling the TIME function )
  1412.  was_dcd  :=  DCD()    ( The result of the DCD function will be put
  1413.                          in the variable 'was_dcd' for later use )
  1414.  timenow := TIME()-start ( Will set 'timenow' to the time elapsed
  1415.                            since the variable 'start' was defined )
  1416.  Conditional Constructions
  1417.  -------------------------
  1418.  Procedures and functions can be used simply,  i.e.  in  a  straight
  1419.  sequence,  or  can  form  part  of  a more complex construction. If
  1420.  commands form part of a construction, then the  actions  taken  are
  1421.  dependant on a particular condition.
  1422.  To  test  for conditions, comaparisons are made between two values.
  1423.  The values used are known as expressions, and  are  can  be  either
  1424.  plain  integers (1, 2, 140 etc.), variables, variable calculations,
  1425.  variable comparisons, functions or anything else which can  produce
  1426.  a boolean value when evaluated (TRUE or FALSE).
  1427.  The  action  taken  by  a  conditional construction is defined by a
  1428.  statement. A statement can be any command,  procedure  or  function
  1429.  call.
  1430.  Valid  syntax  for  calculation  and  comparison  operations are as
  1431.  follows: + - * <= >= = <> OR XOR DIV MOD AND SHL  SHR.  Calculation
  1432.  operations  can  also be applied directly to variables, independant
  1433.  of conditional structures. e.g. num1 := (num2+num3)*num4.
  1434.  There are four types of conditional construction, as follows:
  1435.  IF <Expression> THEN <Statement_sequence> ELSE <Statemene> END;
  1436.  The IF construction is the most commonly used. The execution of the
  1437.  statement  immedately  after  the  'THEN'  is  dependant   on   the
  1438.  expression  specified  being TRUE when evaluated. If the expression
  1439.  proves to be FALSE, then the  action  specified  by  the  statement
  1440.  after the ELSE is executed.  The ELSE part  of the construction  is
  1441.  optional but the whole construction must end with an 'END'.
  1442.  Example:  A boolean variable 'happy' has been previously defined to
  1443.  indicate the users mood. A TRUE value indicates that he was  happy.
  1444.  We can then issue the command:
  1445.       IF happy THEN WriteStr('I am happy');
  1446.       ELSE WriteStr('I am Sad');
  1447.       END;
  1448.  The  WriteStr() command writes text to ther screen and is detailsed
  1449.  later.  As shown, if the 'happy' variable is TRUE THEN  THE  "I  am
  1450.  happy"  message  will  be  displayed.   If the 'happy' variable was
  1451.  FALSE, then the "I am sad" message will  be  displayed.  Note:  The
  1452.  above  command can be written all on one line, but can be split for
  1453.  clarity, as shown. Remeber, DSL is not case sensitive, so upper  or
  1454.  lower case can be used throughout.
  1455.  If  more  than one command is required to be executed, dependant on
  1456.  the expression, then compound statements can be made thus:
  1457.       IF happy THEN
  1458.          WriteStr('I am happy');
  1459.          Alarm;
  1460.          WriteStr('I am very very happy !');
  1461.       ELSE
  1462.          WriteStr('I am Sad, so I'm exiting now !');
  1463.          HaltDeputy;
  1464.        END;
  1465.  WHILE <Expresssion> DO <Statement> END;
  1466.  This condition forms a loop, and is  fairly  self-explanatory.  The
  1467.  expression  is  evaluted  and if found to be TRUE, the statement is
  1468.  executed. The expression is then evaluated again and if still TRUE,
  1469.  the statement is executed again, and so on,  until  the  expression
  1470.  becomes FALSE.
  1471.  REPEAT <Statement> UNTIL <Expression>;
  1472.  This  is  similar  to  the WHILE...DO construction, except that the
  1473.  condition is tested at the bottom of the loop, rather than  at  the
  1474.  top and exits once the condition becomes TRUE.  This means that the
  1475.  statement   is   executed  once,  regardless  of  the  expression's
  1476.  evaluation; from then on the statement is re-executed  continuously
  1477.  until the statement becomes TRUE.
  1478.  CASE <Expression> OF <Integer> : <Statement> ELSE <Statement> END;
  1479.  This  construction  allows  you to execute any number of statements
  1480.  depending on the numercial value of the expression specified.
  1481.  Functions
  1482.  ---------
  1483.  All functions return either a BOOLEAN value (True or False)  or  an
  1484.  INTEGER  (a  whole  number).  Usually,  if a function carries out a
  1485.  specific action (such as dialing a number), then it will  return  a
  1486.  TRUE  value  if  that action was successful, or FALSE if it failed.
  1487.  Deputy is not case sensitive; upper  or  lower  case  can  be  used
  1488.  throughout  a  script.   Functions  can  be used within conditional
  1489.  structures, or the result can be stored in  a  variable  for  later
  1490.  use.
  1491.  To  store  a function's result in a variable, the syntax is: result
  1492.  := function , where result is the variable name - it  must  be  the
  1493.  same  variable  type (boolean or integer) as result returned by the
  1494.  function.
  1495.  The following is a full list of all DSL commands. In this shareware
  1496.  version of the manual we only list the commands themselves, due  to
  1497.  space  constraints.  In the full printed manual, they are listed in
  1498.  full detail, together with examples.
  1499.   I/O and Modem Commands
  1500.   ----------------------
  1501.   PROC Break(Duration);
  1502.   FUNC CTS() : BOOLEAN;
  1503.   FUNC DCD() : BOOLEAN;
  1504.   FUNC DSR() : BOOLEAN;
  1505.   PROC RTS(BOOLEAN);
  1506.   PROC DTR(BOOLEAN);
  1507.   FUNC RI(); BOOLEAN;
  1508.   FUNC Dial(Key) : BOOLEAN;
  1509.   PROC Hangup();
  1510.   PROC Nap();
  1511.   FUNC Receive(Timeout,Flag) : String;
  1512.   FUNC RecChar(Timeout,Flag) : String;
  1513.   PROC SendStr(String);
  1514.   Screen and Keyboard Commands
  1515.   ----------------------------
  1516.   PROC BackGnd(Colour);
  1517.   PROC ForeGnd(Colour);
  1518.   PROC GotoXY(X,Y);
  1519.   PROC ClrScr();
  1520.   PROC ClrEOL();
  1521.   PROC ClrEOS();
  1522.   PROC Cursor(TRUE or FALSE);
  1523.   PROC DelLine();
  1524.   PROC InsLine();
  1525.   PROC StatusLine(TRUE or FALSE);
  1526.   FUNC KeyPressed() : BOOLEAN;
  1527.   FUNC RdKey() : INTEGER;
  1528.   PROC MapKey(Keyvalue,String);
  1529.   FUNC Menu(X,Y,Width,Title,Options...,Flag) : INTEGER;
  1530.   PROC Read(StringName);
  1531.   PROC Silent(TRUE or FALSE);
  1532.   FUNC WhereX() : INTEGER;
  1533.   FUNC WhereY() : INTEGER;
  1534.   PROC WhereMouse(X,Y);
  1535.   FUNC ReadMouse() : INTEGER;
  1536.   PROC Mouse(BOOLEAN);
  1537.   FUNC Window(X,Y,Width,Height,Title,Colour)  : INTEGER;
  1538.   PROC UseWindow(Handle);
  1539.   PROC CloseWindow(Handle);
  1540.   PROC WriteStatus(Text);
  1541.   PROC Write(String);
  1542.   PROC WrStr(String);
  1543.   PROC WrLn(String);
  1544.   File and Disk Commands
  1545.   ----------------------
  1546.   FUNC ChDir(Directory);
  1547.   FUNC MkDir(Directory);
  1548.   FUNC DirFirst(Wildcard,Attrib,Filename,RealAttrib);
  1549.   FUNC DirNext(Filename,Attrib);
  1550.   PROC DOSCMD(Command,Boolean);
  1551.   FUNC Download(Protocol,Filename): BOOLEAN;
  1552.   FUNC Fcopy(SourceFilename,DestFilename) : BOOLEAN;
  1553.   FUNC Fdelete(Filename) : BOOLEAN;
  1554.   PROC Fedit(Filename);
  1555.   FUNC Feof(FileHandle);
  1556.   FUNC Fexists(Filename);
  1557.   FUNC Fopen(Filename) : INTEGER;
  1558.   FUNC FAppend(Filename) : INTEGER;
  1559.   FUNC Fcreate(Filename) : INTEGER;
  1560.   PROC Fclose(HandleVariableName);
  1561.   PROC Fread(HandleVariable,StringVariable);
  1562.   PROC Fwrite(FileHandle,StringVariable);
  1563.   PROC FwriteLn(FileHandle,StringVariable);
  1564.   PROC Fseek(FileHandle,Position);
  1565.   FUNC FTell(FileHandle) : INTEGER;;
  1566.   PROC FRdChar(FileHandle,CharVariable);
  1567.   PROC FWrChar(FileHandle,Char);
  1568.   PROC Ftype(Filename);
  1569.   FUNC DiskSpace() : INTEGER;
  1570.   FUNC CurrentDir() : INTEGER;
  1571.   FUNC Fsize(filename) : INTEGER;
  1572.   FUNC GetString(Filename,SearchKey,StringVariable);
  1573.   PROC OpenLog(Filename);
  1574.   PROC CloseLog();
  1575.   FUNC Upload(Protocol,Filename) : BOOLEAN;
  1576.   Watching and Waiting Commands
  1577.   -----------------------------
  1578.   FUNC Opencount(String) : INTEGER;
  1579.   PROC CloseCount(Handle);
  1580.   FUNC ReadCount() : INTEGER;
  1581.   FUNC Grab(String) : INTEGER;
  1582.   FUNC Grabbed(Handle) : STRING;
  1583.   PROC Delay(Seconds);
  1584.   PROC Tdelay(18ths/sec);
  1585.   FUNC CloseGrab(Handle) : BOOLEAN;
  1586.   FUNC WaitStr(String,Handle) : INTEGER;
  1587.   FUNC DoWait() : INTEGER;
  1588.   FUNC WaitFor(String,Seconds) : BOOLEAN;
  1589.   FUNC WhenSeen(String,SendString): INTEGER;
  1590.   PROC ClearWhen(Handle);
  1591.   Miscellaneous Commands
  1592.   ----------------------
  1593.   FUNC ABS(IntegerVariable) : INTEGER;
  1594.   PROC Alarm([time]);
  1595.   FUNC Arg() : INTEGER;
  1596.   PROC Call(Scriptname,[Argument]);
  1597.   PROC Chain(scriptname[(Argument]);
  1598.   FUNC Cap(CharVariable) : CHARACTER;
  1599.   FUNC Caps(String)
  1600.   FUNC Chr(IntegerVariable): CHARACTER;
  1601.   FUNC Ord(char) : INTEGER;
  1602.   FUNC Date() : STRING;
  1603.   PROC GetEnv(EnvString,ReturnString);
  1604.   FUNC Time() : STRING;
  1605.   PROC DateNow(WeekDay,Day,Month,Year);
  1606.   PROC TimeNow(Hr,Min,Sec);
  1607.   PROC Debug(TRUE or FALSE);
  1608.   FUNC DEC(VariableName[,Decrement]) : INTEGER;
  1609.   FUNC INC(VariableName[,Increment]) : INTEGER;
  1610.   FUNC Encrypt(String,Key) : STRING;
  1611.   FUNC Decrypt(String,Key) : STRING;
  1612.   PROC HaltDeputy;
  1613.   PROC HaltScript;
  1614.   PROC IntToStr(IntegerName,StringName);
  1615.   PROC StrToInt(StringName,VariableName);
  1616.   FUNC Length(String) : INTEGER;
  1617.   PROC Tdelay(Ticks);
  1618.   FUNC POS(String1,String2) : INTEGER;
  1619.   FUNC Slice(StringName,Start,Length) : STRING;
  1620.   PROC PrinterLog(TRUE or FALSE);
  1621.   FUNC ScriptTime() : INTEGER;
  1622.   PROC Shell();
  1623.   FUNC Version() : STRING;
  1624.   Deputy Setup Commands
  1625.   ---------------------
  1626.   FUNC DownloadDir(DirectoryName) : STRING;
  1627.   FUNC DTESpeed(SPEED) : INTEGER;
  1628.   FUNC ExistingFile(OPTION) : INTEGER;
  1629.   FUNC Inactivity(TIME) : INTEGER;
  1630.   FUNC CharDelay(Ticks) : INTEGER;
  1631.   FUNC LineDelay(Ticks) : INTEGER;
  1632.   FUNC SetEmulation(Emulation) : INTEGER;
  1633.   FUNC SetMNP(Level) : INTEGER;
  1634.   FUNC SetParity(TYPE) : INTEGER;
  1635.   FUNC SetPort(PORT) : INTEGER;
  1636.   FUNC AutoCis(TRUE or FALSE);
  1637.   FUNC AutoZ(TRUE or FALSE);
  1638.   FUNC CRLFIN(TRUE or FALSE);
  1639.   FUNC CRLFOUT(TRUE or FALSE);
  1640.   FUNC LocalEcho(TRUE or FALSE);
  1641.   FUNC RemoteEcho(TRUE or FALSE);
  1642.   FUNC SetStrip(TRUE or FALSE);
  1643.   FUNC SoftFlow(TRUE or FALSE);
  1644.   FUNC HardFlow(TRUE or FALSE);
  1645. SCRIPT Mickey;
  1646. (* Deputy DSL Demonstration Script Version 1.3 *)
  1647. (* Copyright 1992 Michael Spalter & S/E/G *)
  1648. (* This script makes use of the following DSL commands:
  1649.    Functions Returning Booleans        Procedures
  1650.    ----------------------------        ----------
  1651.    Fexists(filename)                   FDelete(filename)
  1652.    DCD                                 FRename(oldname,newname)
  1653.    FEOF(filehandle)                    Write(string)
  1654.    KeyPressed                          WrLn
  1655.                                        ClrScr
  1656.                                        Hangup
  1657.    Functions Returning Integers        WriteStatus(String)
  1658.    ----------------------------        Alarm
  1659.    FileSize(filename)                  ForeGnd(colour)
  1660.    ScriptTime                          BackGnd(colour)
  1661.    Pos(searchstring,bigstring)         OpenLog(filename)
  1662.    Length(stringvar)                   CloseLog
  1663.    ABS()    WhereY                     GoToXY(x,y)
  1664.    Menu(....)                          StatusLine(Boolean)
  1665.                                        INC(integervar[,number])
  1666.    Functions Returning Strings         StrToInt(string,intvar)
  1667.    ---------------------------         Read(stringvar)
  1668.    Time
  1669.    Date
  1670.    Caps(StringVar)   *)
  1671. (* First, define the variables used in the script *)
  1672. VAR YourName:String[18];
  1673.     Happiness:Integer;
  1674.     Value:Integer;
  1675.     FileLine:String[78];
  1676.     ValueString:String[15];
  1677.     LineCount:Integer;
  1678.     FileBytes:Integer;     (* This is an enclosed comment *)
  1679.     People:String[20];     (* Comments can be placed anywhere *)
  1680.     FileHandle:Integer;    (* and are ignored by Deputy's Compiler *)
  1681.    (* Note: Apostrophes and Inverted commas are identical in function
  1682.       It's best to use one type. In this script we have tried to use
  1683.       apostrophes only,but where we need to write an apostrophe
  1684.       to the screen, we use the inverted commas instead. *)
  1685.    (* Now the actual main script body starts *)
  1686.    BEGIN
  1687.    StatusLine(TRUE);
  1688.    ClrScr;
  1689.    WriteStatus('        Welcome to the Deputy Demonstration script !');
  1690.    StatusLine(TRUE);
  1691.    Alarm();
  1692.    OpenLog('Test.LOG');
  1693.    GoToXY(20,10);
  1694.    Write(' Hold on a few seconds......');
  1695.       WHILE ScriptTime()<3 DO END;
  1696.    WrLn;
  1697.    ClrScr;
  1698.    WriteStatus('');
  1699.    GoToXY(0,5);
  1700.    Write("\t The date is ",Date,", and the time is ",Time);  WrLn;
  1701.    Write('\t This is a sample script using the Deputy');  WrLn;
  1702.    Write('\t script language. It is designed to show ');  WrLn;
  1703.    Write('\t the use of as many commands as possible.');  WrLn;
  1704.    FileBytes:=FSize('DEPUTY.EXE');
  1705.    Write('\t The Deputy program is ',Filebytes,' bytes long,'); WrLn;
  1706.    Write('\t and this script has been running ',ScriptTime(),' Secs.');
  1707.    WrLn; WrLn;
  1708.    Write('\t Who is with you (their names please) ? ');
  1709.    Read(People); WrLn;
  1710.       IF POS('JIM',Caps(People))<>-1 THEN
  1711.       Write('\t I see that Jim is with you !'); WrLn;
  1712.       ELSE
  1713.       Write('\t I see that Jim is NOT with you with you !'); WrLn;
  1714.       END;
  1715.    Write('\t By the Way, that string was ',Length(People),' bytes');
  1716.    WrLn; WrLn;
  1717.    Write('\t Please enter a negative number: ');
  1718.    Read(ValueString); WrLn;
  1719.    StrToInt(ValueString,Value);  (* Convert it to an Integer first *)
  1720.    Write('\t Okay. Without the sign, it equals ',ABS(Value)); WrLn;
  1721.    Write('\t The Cursor is now at ',WhereX,',',WhereY()); WrLn;
  1722.    WrLn;
  1723.    Write("\t Please type in your first name: ");
  1724.    Read(YourName); WrLn;
  1725.    Write("\t I'm now going write your name to a file....");
  1726.    Filehandle := FCreate('TestFile.TXT');
  1727.    FWrite(FileHandle,YourName);
  1728.    FClose(FileHandle);
  1729.    Write('Done ! '); WrLn; WrLn;
  1730.       IF NOT Fexists('TestFile.TXT') THEN
  1731.       Write("\t Arrgghh ! File didn't Write properly !"); WrLn;
  1732.       ELSE
  1733.       Write("\t That seemed to work. Now I'll read it back.....");
  1734.       YourName:= '';     (* Clear the String *)
  1735.       FileHandle := FOpen('TestFile.TXT');
  1736.       FRead(FileHandle,YourName);
  1737.       FClose(FileHandle);
  1738.       Write('Done !'); WrLn;
  1739.       Write("\t According to the file, your name is ",YourName,".");
  1740.       WrLn;
  1741.       Write("\t I'll just delete that file now."); WrLn;
  1742.       FDelete('TestFile.TXT');
  1743.       END;
  1744.    WrLn;
  1745.    Write('\t Press any key to go on......');
  1746.    WHILE NOT Keypressed() DO END;
  1747.    WrLn;
  1748.    ClrScr();
  1749.    REPEAT Value:=RdKey() UNTIL NOT Keypressed();   (* Clear Kbd Buffer *)
  1750.         Happiness := 1 + Menu(24,3,30,"How happy are you ?",
  1751.                          "1 - Extremely happy ",
  1752.                          "2 - Very Happy ",
  1753.                          "3 - Quite Happy   ",
  1754.                          "4 - Content",
  1755.                          "5 - Nonchalent",
  1756.                          "6 - A little sad",
  1757.                          "7 - Upset",
  1758.                          "8 - Completely distraught",28);
  1759.       GoToXY(0,2);
  1760.       CASE Happiness OF
  1761.       1: Write("\t So, you're extremely happy - Good !");|
  1762.       2: Write("\t You're very happy apparently");|
  1763.       3: Write("\t You are quite happy - that's nice");|
  1764.       4: Write("\t You are content - barely happy :-(");|
  1765.       ELSE
  1766.       Write("\t You are not happy at all - what a shame!");
  1767.       END;
  1768.      WrLn; WrLn;
  1769.         IF NOT DCD THEN
  1770.         Write('\t You are currently not online.'); WrLn;
  1771.         ELSE
  1772.         Write("\t You are currenly online, I'll just hangup"); WrLn;
  1773.         Hangup;
  1774.         END;
  1775.      CloseLog;
  1776.      FRename('Test.LOG','NewTest.LOG');
  1777.      WrLn;
  1778.      Write("\t Press a key to see a directory of your disc....");
  1779.      WHILE NOT Keypressed() DO END;
  1780.      REPEAT Value:=RdKey() UNTIL NOT KeyPressed();  (* Clear Kbd Buffer *)
  1781.      DOSCMD('CLS',FALSE);
  1782.      DOSCMD('DIR /w',TRUE);
  1783.      ClrScr;
  1784.      GoToXY(0,2);
  1785.         If Fexists('NewTest.LOG') THEN
  1786.         Write("\t Press any key for a review.......");
  1787.         WHILE NOT Keypressed() DO END;
  1788.         Happiness := RdKey();
  1789.         WrLn; WrLn;
  1790.         FileHandle:=FOpen('NewTest.LOG');
  1791.         LineCount:= 0;
  1792.         Repeat
  1793.         FRead(FileHandle,FileLine);
  1794.         ForeGnd(White);
  1795.         Write('Review [ ');
  1796.         ForeGnd(Yellow);
  1797.         Write(FileLine);
  1798.         Foregnd(White);
  1799.         GoToXY(79,WhereY()); Write(']'); WrLn;
  1800.         INC(LineCount);
  1801.            If LineCount MOD 10 = 0 THEN
  1802.            WrLn;
  1803.            Write(' [ Press any key to continue ]');
  1804.            WHILE NOT Keypressed() DO END;
  1805.            While Keypressed() DO RdKey() END;
  1806.            WrLn; WrLn;
  1807.            END;
  1808.         UNTIL FEOF(FileHandle);
  1809.         WrLn;
  1810.         FClose(FileHandle);
  1811.         FDelete('NewTest.LOG');
  1812.         Write(' [ End of Review (Length: ',LineCount,' Lines) ]');
  1813.         END;
  1814.         WrLn; WrLn;
  1815.         Write('That is the end of the script !'); WrLn; WrLn;
  1816.  Deputy is normally started by simply typing DEPUTY at  the  command
  1817.  line.   There are however a number of options which can be added as
  1818.  arguments to alter the way Deputy works. The syntax is:
  1819.       DEPUTY -rts -bw -vpix -x nn -tcp -18 script.scr
  1820.  Some slow PC's may take longer to complete disc writes during  file
  1821.  downloads  or  logging  -  if  this causes you constant errors, the
  1822.  '-rts' suffix on the command line will enable RTS  toggling  during
  1823.  disc writes.
  1824.  If  you  are using a black and white monitor and you intend calling
  1825.  colour services such as Prestel (or a service  using  ANSI  colour)
  1826.  then  the dark colours such as red may not be visible. Use this -bw
  1827.  option to foce all shades to white.
  1828.  If you want to automatically execute a DSL script from the  command
  1829.  line,  then  you can do so by typing the script name, as shown.  It
  1830.  must be a precompiled script, not a .DSL file.
  1831.  The -x nn parameter allows you to specify a timeout value for  Xoff
  1832.  interpretation  if  you are using soft flow control. nn should be a
  1833.  decimal value in second.
  1834.  The -tcp and -vpix options are specialised facilities  for  network
  1835.  services and should not be used for normal operation.
  1836. The  publisher  and  Authors  would  like  to express their grateful
  1837. thanks to everyone  involved  in  the  development  of  Deputy.   In
  1838. particular,   the   following   for  their  considerable  help  with
  1839. Beta-Testing Deputy, in no particular order:
  1840. Alan Saul             Paul Whelan    Barry Parker   David Senior
  1841. Don Milne             Chris Moore    Dave Parry     Dave Buckley
  1842. Charles Gillanders    Mel Pullen     David Debono   Geoff Boyle
  1843. Simon Brierley-Jones  Glyn Foster    Graham Creek   Rob Nicholson
  1844. Vassilis Konstantinou Keith Howell   Ken Coyne      Sean Keogh
  1845. Alec Chattaway        Gary Marden    Richard Cox    Martin Rodgers
  1846. Matthew Simms         Martyn Bright  Mike Rogers    Mike Zanker
  1847. Peter Ellefsen        Pete Bentley   Paddy O'Hanlon Rod Ellery
  1848. Simon Bramfitt        Rob Rook       Tim Wilson     Peter Humphrey
  1849.